<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>io_context::strand::post (1 of 2 overloads)</title>
<link rel="stylesheet" href="../../../../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="../../../../boost_asio.html" title="Boost.Asio">
<link rel="up" href="../post.html" title="io_context::strand::post">
<link rel="prev" href="../post.html" title="io_context::strand::post">
<link rel="next" href="overload2.html" title="io_context::strand::post (2 of 2 overloads)">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
<td align="center"><a href="../../../../../../index.html">Home</a></td>
<td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../post.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../post.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../boost_asio.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="overload2.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="section">
<div class="titlepage"><div><div><h5 class="title">
<a name="boost_asio.reference.io_context__strand.post.overload1"></a><a class="link" href="overload1.html" title="io_context::strand::post (1 of 2 overloads)">io_context::strand::post
          (1 of 2 overloads)</a>
</h5></div></div></div>
<p>
            Request the strand to invoke the given function object.
          </p>
<pre class="programlisting">template&lt;
    typename Function,
    typename Allocator&gt;
void post(
    Function &amp;&amp; f,
    const Allocator &amp; a) const;
</pre>
<p>
            This function is used to ask the executor to execute the given function
            object. The function object will never be executed inside this function.
            Instead, it will be scheduled to run by the underlying <a class="link" href="../../io_context.html" title="io_context"><code class="computeroutput">io_context</code></a>.
          </p>
<h6>
<a name="boost_asio.reference.io_context__strand.post.overload1.h0"></a>
            <span class="phrase"><a name="boost_asio.reference.io_context__strand.post.overload1.parameters"></a></span><a class="link" href="overload1.html#boost_asio.reference.io_context__strand.post.overload1.parameters">Parameters</a>
          </h6>
<div class="variablelist">
<p class="title"><b></b></p>
<dl class="variablelist">
<dt><span class="term">f</span></dt>
<dd>
<p>
                  The function object to be called. The executor will make a copy
                  of the handler object as required. The function signature of the
                  function object must be:
</p>
<pre class="programlisting">void function();
</pre>
<p>
                </p>
</dd>
<dt><span class="term">a</span></dt>
<dd><p>
                  An allocator that may be used by the executor to allocate the internal
                  storage needed for function invocation.
                </p></dd>
</dl>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright © 2003-2021 Christopher
      M. Kohlhoff<p>
        Distributed under the Boost Software License, Version 1.0. (See accompanying
        file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
      </p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../post.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../post.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../boost_asio.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="overload2.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>
